Summary

Sets up the development environment for the Cursor Cloud VM and documents the non-obvious caveats discovered during setup.

This is a pure static Astro + Svelte SPA (no backend/DB/auth). Setup was: install Node 24 (via nvm) and npm ci. Lint, type check, build, and the dev server all pass, and the core quiz flow was verified end to end.

Changes

• Add ## Cursor Cloud specific instructions to AGENTS.md covering:
  • Node version mismatch (repo pins Node 24; VM default /exec-daemon/node is Node 22 — Node 24 prepended in ~/.bashrc).
  • Use npm run dev in cloud (the astro dev --background helper is a local dotagents tool not present in cloud).
  • Commit with git commit --no-verify (the .git-hooks/pre-commit gate sources ~/code/dotagents, absent in cloud).
  • How to run gate steps directly for verification.

Testing

• ✅ npm run check (0 errors, 0 warnings)
• ✅ npm run build (static build completed)
• ✅ npm run dev (serves http://localhost:4321, HTTP 200)
• ✅ Manual quiz flow: opened "Quiz Basics", answered a question (graded correct), advanced to next question — console clean.